home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / chksum2.zip / README < prev   
Text File  |  1989-03-13  |  3KB  |  77 lines
  1.     readme    890313    NHA
  2.  
  3. Chksum is a program which calculates a 32-bit checksum for one or more
  4. files.  Optionally it will also count the characters in the file.
  5. All I/O is through DOS, so any machine running DOS (version 2.0 or later,
  6. I think) should suffice.  On my At-03 with a disk cache program,
  7. it runs at 1 MByte/minute, which is about the limit using DOS.
  8.  
  9. Filenames are taken from the command line, with two special filenames
  10. to provide more flexibility.  The special filename '-' means to read
  11. the standard input as a file.  The special filename '--' means to
  12. read a list of filenames (1 per line) from the standard input.  This
  13. last capability, in conjunction with Rahul's STUFF or the standard
  14. unix FIND command, enables one to perform checksumming over entire
  15. directory trees.
  16.  
  17. This program has also been distributed in source (C) form, and runs
  18. with identical results under 4.3bsd on a VAX.  Note that under DOS
  19. wildcard characters in a filename are not expanded.  Note also that
  20. if you copy a file between DOS and UNIX you will probably get different
  21. checksums if you used the default ASCII mode in FTP.
  22.  
  23. Special care has been taken to ensure that the total checksum for
  24. a group of files will be identical to that for their concatenation.
  25. That means that the following two invocations will produce the
  26. same grand total:
  27.  
  28.     chksum  file1  file2  file3
  29.     cat file1 file2 file3  |  chksum -
  30.  
  31. This is useful for the paranoid after using the unix SPLIT command.
  32.  
  33. Invoking the command  'chksum'  or  'chksum -h' results in the following
  34. output:
  35.  
  36.     chksum -- calculate 32-bit checksum for file(s), output to stdout
  37.     Usage:    chksum   [-cehtv]    {file|--|-}...
  38.     -c    Count bytes also
  39.     -e    give extended Error reports on stderr
  40.     -h    Help; give this help message and exit
  41.     -t    Total only; don't list sum for each file
  42.     -v    Verbose; list filenames along with checksums
  43.     --    take filenames from stdin, 1 name per line
  44.     -    take stdin as a file
  45.     Filenames may be mixed with options.
  46.     Exit status is the number of file errors encountered.
  47.  
  48. When I say that filenames may be mixed with options, I mean that
  49. the command line is read from left to right, and anything found is
  50. acted upon as soon as it is seen.  Thus you could do something like:
  51.  
  52.     chksum foo -c bar
  53.  
  54. And you would receive a byte count for bar, but not for foo.
  55. At the moment option characters cannot be combined (-vc) and
  56. the DOS switchar is ignored; '-' is always used for options and
  57. pathnames are simply handed to DOS.
  58.  
  59. To confirm that you got all the right bits, try running the following
  60. command:
  61.  
  62.     chksum -v -c chksum.exe
  63.  
  64. The output should be:
  65.  
  66.     56755e1f       11198   chksum.exe
  67.  
  68. Complaints, suggestions, compliments should be directed to me at the
  69. below-specified address(es):
  70.  
  71. NHA
  72. ---
  73. PAPER:  Norman Azadian; Hasler AG; Belpstrasse 23; 3000 Berne 14; Switzerland
  74. X.400:  naz@hslrswi.hasler
  75. UUCP:   ...{uunet,ukc,mcvax,...}!cernvax!hslrswi!azadian
  76. VOICE:  +41 31 63 2178            BITNET: naz%hslrswi.UUCP@cernvax.BITNET
  77.